Copyright: Copyright © Michaël RENARD / The MCR Company
Citation: Under the blue sky, the sun lights


Contents
VB/Tracer-Profiler (version 2.00)

Contents

Overview

VB/Tracer-Profiler

Revision History

New Features

Installation

Technical Support

Registering 'VB/Tracer-Profiler'

License Agreement

Distribution Note

Acknowledgement


@Blank

Purpose :

Declare Syntax :

Call Syntax :

Where :

Comments :

Examples :

See also :


Add
Select this command box, if you want to add tracer-profiler to your application.


List1
This list show all files founden in your VB .MAK file.

You can see the old size and the new size of each files.


MakInProgress
This bar show the current progress in your VB .MAK file.


Distribution Note

When you create and distribute applications that use 'VB/Tracer-Profiler', you should install the file VBTRCPRF.DLL in the customer's Microsoft Windows WINDOWS\SYSTEM subdirectory. The setup kit included with Visual Basic provides tools that help you write setup programs that install your applications correctly.

You are not allowed to distribute 'VBTRCPRF.LIC' file with any application that you distribute.


Dir1
Select the directory containing your application.


Drive1
Select the disk containing your application.


ReadTracer
Push on this button to read the selected traced file.


Remove
Select this command box, if you want to remove tracer-profiler to your application.


Revision History

See also : New Features

Version	Comments

2.00	no revision.

1.14	Solve a little incompatibility with 'VB/Error Hander'.

Correct the library definition in file VBPRFTRC.BAS

1.07	no revision.

1.00	Initial release of the 'VB/Tracer-Profiler'.


New Features

See also : Revision History

Version	Comments

2.00	Add the selection of a target disk/directory to store the traced/profiled file.

1.14	no new features.

1.07	Minimize the space required for the traced/profiled file.

1.00	Initial release of the 'VB/Tracer-Profiler'.


VB/Tracer-Profiler

'VB/Tracer-Profiler' is an easy to use program to perform the adding/removing of traced/profiled informations to all source files in a VB .MAK file.

The traced/profiled informations give you the opportuneness to see the path of all routines in your application and the speed of each routine.

Push on hot-spots (hand cursor) to see the meaning of each object.


Exit
Select this command box, if you want to exit of 'VB/Tracer-Profiler'.


Installation

Demonstration version :

The files VBTRCPRF.DLL and VBTRCPRF.HLP should be copied in your WINDOWS directory.

Registered version :

The files VBTRCPRF.DLL, VBTRCPRF.HLP should be copied in your WINDOWS\SYSTEM directory.

The file VBTRCPRF.LIC should be copied in your WINDOWS directory.

Distribution note:

You don't need to distribute the information for the tracer-profiler. The information is for your usage to optimize your work.

You are not allowed to distribute 'VBTRCPRF.LIC' file with any application that you distribute.


File1
Select the file containing your application.


English
Select this option box, if you want to have the English Language.


File2
Select the traced file containing the informations.


pfAverageTime
Push on the title to sort the informations by 'Average Time'.


Null
Select this check to see the information with a null total calls.


File3
Select the profiled file containing the informations.


Dir4
Select the directory which will contain the traced/profiled files.


Drive4
Select the disk which will contain the traced/profiled files.


pfMinTime
Push on the title to sort the informations by 'Minimum Time'.


pfTotalTime
Push on the title to sort the informations by 'Total Time'.


pfCalls
Push on the title to sort the informations by 'Total Calls'.


pfRoutine
Push on the title to sort the informations by 'Routine'.


pfModule
Push on the title to sort the informations by 'Module'.


Descending
Select this option to see the information in a descending order.


Ascending
Select this option to see the information in an ascending order.


Dir3
Select the directory containing the profiled file.


RoutineInProgress
This bar show the current progress in each file in your VB .MAK file.


VB/Tracer

'VB/Tracer' read all informations stored in a traced file (*.-TR)

Push on hot-spots (hand cursor) to see the meaning of each object.


Dir2
Select the directory containing the traced file.


Preferences
Select this tabbed dialog to change some parameters.


French
Select this option box, if you want to have the French Language.


pfMaxTime
Push on the title to sort the informations by 'Maximum Time'.


List2
This list show all routines informations in the selected traced file.

handle is the routine number gived when you've added the tracer-profiler.

module is the name of each traced module.

routine is the name of each traced routine.


pfHandle
Push on the title to sort the informations by 'Handle'.


Technical Support

Only registered users can receive support and update.

To receive support, you must specify your registration ID.

However, any report on any problem are the welcome.

The following information may be of help to you in streamlining your efforts to resolve any technical problems you may have with 'VB/Tracer-Profiler' program.

GPF?

If you are getting a GPF (General Protection Fault), write down the information that is displayed when the error occurs.  Also, make a note of what your code was doing (in general terms.)

ISOLATE IT

Try to isolate the cause of the error.  If at all possible, step through your code with F8 and F9.  Try to find the one line of code that is causing the error.

SCALE IT DOWN

If at all possible, try to reproduce the problem in a small test program that you can send in.  Send your test on CompuServe.

CompuServe Mail:

Name : 	Michaël RENARD

CIS : 	100042,3646

I'm on CompuServe one time a day (after 19 o'clock European Time).


License Agreement

The 'VB/Tracer-Profiler' program and its associated DLL is not public domain software or free software.

The 'VB/Tracer-Profiler' program and its associated DLL  is copyrighted, and all rights are reserved by its author: Michaël Renard.

You are licensed to use this software on a restricted number of computers. You may copy the software to facilitate your use of it on as many computers as there are licensed users specified in the 'VB/Tracer-Profiler' license file 'VBTRCPRF.LIC'. Making copies for any other purpose violates international copyright laws.

You are not allowed to distribute 'VBTRCPRF.LIC' file with any application that you distribute.

Disclaimer:

This software is sold AS IS without warranty of any kind, either expressed or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. The authors assume no liability for any alleged or actual damages arising from the use of this software. (Some states do not allow the exclusion of implied warranties, so the exclusion may not apply to you.)

Your use of this product indicates that you have read and agreed to these terms.


Acknowledgement

This help has been writed by using ForeHelp v1.04 from ForeFront, Inc.


Overview

'VB/Tracer-Profiler' is a program to add/remove automatically the tracer-profiler's information in a VB .MAK file.

'VB/Tracer-Profiler' have an another approach to minimize the use of memory. It use an external file did contains all routines founded in the source file. Only a basic module will be added to your application (not a .FRM module).

'VB/Tracer-Profiler' creates 2 files for each project. These files are stored in the selected directory.

Don't forget that the traced/profiled information is only use to perform some path application and speed measurement. When you want to distribute your final application, remove all traced/profiled information in your project. These informations are not usable for the finale release of an application.

I hope that 'VB/Tracer-Profiler' will be a great advantage for you and for your application.

'VB/Tracer-Profiler' works ONLY with modules SAVED IN TEXT MODE.


Registering 'VB/Tracer-Profiler'

The easiest way to Register 'VB/Tracer-Profiler' is through CompuServe's SWREG forum.

1) GO SWREG

2) Choose Register Shareware.

3.1) 'VB/Tracer-Profiler' SWREG ID is : #5295 (ONLY if you're a REGISTERED user of 'TIME TO WIN' #4045).

3.2) 'VB/Tracer-Profiler' SWREG ID is : #5294 (only if you're NOT a REGISTERED user of 'TIME TO WIN' #4045).

As soon as I receive notification of your registration (usually 1 - 3 days) I will send you out via e-Mail the latest version and a license file for one site (only if lastest version is available (not currently in test)) if not you receive the license file for one site.

You also qualify to receive new versions of 'VB/Tracer-Profiler' during one year.

The price for 'VB/Tracer-Profiler' is fixed at $34.00 (ONLY if you're a REGISTERED user of 'TIME TO WIN' #4045).

The price for 'VB/Tracer-Profiler' is fixed at $43.00 (only if you're NOT a REGISTERED user of 'TIME TO WIN' #4045).

If you're NOT a REGISTERED user of 'TIME TO WIN' and you register 'VB/Tracer-Profiler' at the low price ($34.00), I can't send you the product and I wait until that you register 'TIME TO WIN'.

This price is much a contribution to my works that a payment. When you register 'VB/Tracer-Profiler', you help me to develop better products and others products.

'VB/Tracer-Profiler' is written in Visual Basic 3.0 and its associated DLL in C and compiled using Visual C++ 1.51.

The DLL code has been optimized for 80386 use with the 'maximize speed' option.

Others products :

1) 'TIME TO WIN' SWREG #4045 (more over 565 routines for VB 3.0).

2) 'VB/Error Handler' SWREG #4380 (add/remove error handler for VB 3.0).


ReadProfiler
Push on this button to read the selected profiled file.


Drive2
Select the disk containing the traced file.


VB/Profiler

'VB/Profiler' read all informations stored in a profiled file (*.-PF)

Push on hot-spots (hand cursor) to see the meaning of each object.


Drive3
Select the disk containing the profiled file.